home *** CD-ROM | disk | FTP | other *** search
/ Network PC / Network PC.iso / amiga utilities / communication / internet / amitcp3.0b / src.lha / src / amitcp / api / auto_nonsocket.c < prev    next >
Encoding:
Text File  |  1996-09-08  |  3.5 KB  |  117 lines
  1.  
  2. /****** bsdsocket.library/getdtablesize *************************************
  3.  
  4.     NAME
  5.         getdtablesize - get socket descriptor table size
  6.  
  7.     SYNOPSIS
  8.  
  9.         nfds = getdtablesize()
  10.         D0
  11.  
  12.         long getdtablesize(void);
  13.  
  14.     FUNCTION
  15.         Return value of maximum  number of open socket  descriptors.
  16.         Larger  socket  descriptor  table  can   be  allocated  with
  17.         SocketBaseTagList() call.
  18.  
  19.     SEE ALSO
  20.         SocketBaseTagList()
  21.  
  22. *****************************************************************************
  23. *
  24. */
  25.  
  26. /****** bsdsocket.library/syslog ********************************************
  27.  
  28.     NAME
  29.         syslog, vsyslog - write message to AmiTCP/IP log.
  30.  
  31.     SYNOPSIS
  32.         #include <syslog.h>
  33.  
  34.         vsyslog(level, format, ap)
  35.                 D0     A0      A1
  36.  
  37.         void syslog(unsigned long level, char * format, ...); 
  38.  
  39.         void vsyslog(unsigned long level, char * format, ap); 
  40.  
  41.     FUNCTION
  42.         Writes the message given as format string and arguments
  43.         (printf-style) both to the log file and to the console.
  44.         The message is prepended with the name of the calling
  45.         application, if the name is known by AmiTCP (the standard
  46.         autoinitiazer module in the net.lib passes the name of the
  47.         application to AmiTCP).
  48.  
  49.         The level is selected from an ordered list:
  50.  
  51.             LOG_EMERG           A panic condition.
  52.  
  53.             LOG_ALERT           A condition that should be
  54.                                 corrected immediately, such as a 
  55.                                 corrupted system database.
  56.  
  57.             LOG_CRIT            Critical conditions, such  as  hard
  58.                                 device errors.
  59.  
  60.             LOG_ERR             Errors.
  61.  
  62.             LOG_WARNING         Warning messages.
  63.  
  64.             LOG_NOTICE          Conditions that are not error  con-
  65.                                 ditions,  but that may require spe-
  66.                                 cial handling.
  67.  
  68.             LOG_INFO            Informational messages.
  69.  
  70.             LOG_DEBUG           Messages that  contain  information
  71.                                 normally of use only when debugging
  72.                                 a program.
  73.  
  74.     INPUTS
  75.         Level     - indicates the type of the message. The levels
  76.                     are defined in sys/syslog.h and listed above.
  77.  
  78.         format    - This is a printf-style format string.
  79.  
  80.         arguments - as in printf().
  81.  
  82.         ap        - pointer to an array of arguments.
  83.  
  84.     RESULT
  85.         Returns no value.
  86.  
  87.     EXAMPLES
  88.         To log a message at priority LOG_INFO, it would make the
  89.         following call to syslog:
  90.  
  91.             syslog(LOG_INFO,  "Connection from host %s",
  92.                    CallingHost);
  93.  
  94.     NOTES
  95.         In contrast to the previous releases of the AmiTCP/IP, the
  96.         integer arguments are expected to be 32 bits wide, thus
  97.         eliminating the need to specify the 'l' size modifier for the
  98.         number formatters.
  99.  
  100.         This function is callable from interrupts.
  101.  
  102.     BUGS
  103.         Because there is a limited number of internal messages used
  104.         by the logging system, some log messages may get lost if a
  105.         high priority task or interrupt handler sends many messages
  106.         in succession. If this happens, the next log message tells
  107.         the fact. 
  108.  
  109.     SEE ALSO
  110.         net.lib/syslog for syslog utility functions (openlog(),
  111.         closelog() and setlogmask()),
  112.         C-library printf() documentation
  113.  
  114. *****************************************************************************
  115. *
  116. */
  117.